home *** CD-ROM | disk | FTP | other *** search
/ Hack-Mag 1 / Hack-Mag - Issue 1 (1990-08-22)(D-Tect)(PD).adf / Soundtracker-Replays / NewPlayer.doc < prev    next >
Text File  |  2014-06-19  |  4KB  |  124 lines
  1. ;        AT LAST SOMEONE DID A CHANGE ON IT!
  2. ;
  3. ;            AMICOM - THE HARDWARE WIZARD
  4. ;
  5. ;                 PRESENTS
  6. ;
  7. ;         AMICOM'S FAST SOUNDTRACKER PLAYER
  8. ;
  9. ;              DONE IN 8-1989
  10. ;            BY THE POWER OF SPREADPOINT
  11. ;
  12. ;--------------------------------------------------------
  13.  
  14. This is the official documentation file for a new generation
  15. of soundtracker players.
  16.  
  17.  
  18.  
  19.     MAJOR CHANGES:
  20. --------------------------------------------------------
  21.  
  22. 1)    THE MEGASTUPID SHIT THAT THE SOUNDFILE COULD NOT BE
  23.     SEPERATED FROM THE PLAYER IS NOW GONE!!!!
  24.  
  25.     You can now locate your player in fast (32bit if you have)
  26.     RAM and only the sound data in CHIP memory.
  27.     You must write the base address of your sound file in
  28.     a longword at 'songPtr' before you call 'soundinit'.
  29.  
  30. 2)    THE MEGASTUPID WAITING ROUTINE (FOR DMA OFF) HAS BEEN FIXED.
  31.  
  32.     Now, the waiting delay time is no longer wasted, but can
  33.     fully be used by your other routines - thanks to interrupts.
  34.     As an automatic consequence, the waiting delay does no longer
  35.     depend on the CPU type and speed, but is fix and can be
  36.     specified in raster lines. The default value used in the
  37.     player is 8 raster lines. This appears to be the minimum
  38.     required for correct operation. You can specify any value.
  39.     The amount of time consumed by the routine does not depend on
  40.     this delay. However, too large a delay might be audible.
  41.  
  42. 3)    EXTRA SPEED IMPROVEMENT USING PIPELINING
  43.  
  44.     The problem in the old version was that usually 5 times
  45.     almost nothing was done, then everything in one go.
  46.     This caused an even higher loss of CPU time.
  47.     The current verion has a pipelining system that spreads
  48.     some of the work over 5 access times. As a consequence, the
  49.     maximum play speed can no longer be less than 5.
  50.  
  51. 4)    PC-RELATIVE CODE
  52.     At last! This version was made PC-rel by Power Point.
  53.     You can locate it anywhere without using violated absolute
  54.     addressing mode or 'relocation' code modification.
  55.  
  56. 5)    CODE OPTIMIZATION BY POWER POINT
  57.     An overall code optimization reduces code length as well as
  58.     the consumed time.
  59.  
  60. 6)    ERRORS CORRECTED
  61.     There was a bug in the command routine 'setSpeed' which
  62.     could cause a short pause during soundplay when used.
  63.  
  64.     In the portamento routines, a funny value (less than 124)
  65.     was used as lower boundary for the sample play period.
  66.     The Amiga cannot by DMA play samples correctly at a period
  67.     less than 124.
  68.  
  69.  
  70.     COMPATIBILITY
  71. -----------------------------------------------------------------
  72.  
  73. 1)    The soundtracker is NOT ibm-compatible. (Thank God for that)
  74.  
  75. 2)    It is compatible with 31 instrument modules. Use the soundtracker
  76.     to upgrade your old 15 intrument modules to the new standard.
  77.  
  78. 3)    You can not use songs that need a soundspeed less than 5
  79.     at any time during play. (Such songs are very uncommon)
  80.  
  81.     As far as we know, everything else should be the same
  82.     as in earlier Spreadpoint players.
  83.  
  84.  
  85.  
  86.     HOW TO USE: low-level applications
  87. -------------------------------------------------------------------
  88. Do everything like normal except:
  89.  
  90. 1)    if yuo're not located in CHIP-memory, allocate regions for the
  91.      the modules you want to use. Copy the sounddata into CHIP memory.
  92.  
  93. 2)    To enable the player
  94.     - call 'timerinit'
  95.     - enable the level6 ('Exter') interrupt
  96.  
  97. 3)    When you want to play a specific module:
  98.     - write its base address to the label 'songPtr'
  99.     - call 'soundinit'
  100.     Also call 'soundinit' when you want to rebegin the current song.
  101.  
  102. 4)    When youre finished playing sound
  103.     - call soundoff
  104.     - then call timerexit
  105.  
  106. 5)    All routines except the actual player are saving all
  107.     CPU registers they use. ( stp35 only )
  108.  
  109. 6)    You need not preserve the status of any hardware register.
  110.     All registers used by the player are automatically
  111.     restored to the values they had on init.
  112.  
  113.  
  114.  
  115.  
  116.     HOW TO USE: high-level (DOS) applications
  117. -----------------------------------------------------------------
  118. This player cannot be used while AmigaDOS is running.
  119. Try starting the exampleplayer, then click on an icon using
  120. keyboard-mouse functions!
  121. A seperate version suitable for multitasking will soon be
  122. provided.
  123.  
  124.